FWZdoc; FWZIP Manager On-Line Help Documentation - Search On [] FWZdoc; FWZIP ManagerInstructions November 13, 1990Version 1.00 Start Help NOTE: Placed throughout these instructions are key phrases used by FWZIP Manager's on-line help, like the "Start_Help" above.] FWZIP Manager is a macro for using the PKZIP file compression program from inside Framework III. That is, FWZIP Manager is a Framework III "front-end" for PKZIP. YOU MUST HAVE A COMPATIBLE VERSION OF PKZIP (see note below). All functions of PKZIP are accessible through FW prompt line menus, a feature which makes PKZIP much easier to use. In addition, from its prompt line menu, FWZIP Manager allows you to set the DOS path for PKZIP to use, choose to run PKZIP functions in a FW3 window or from DOS roll-out, and copy, move, re-name or delete *.zip files. In essence FWZIP Manager is a complete Framework III front-end for PKZIP (see note below). FWZIP Manager was inspired by a similar program available under Windows 3.0, but, frankly (and modestly), FWZIP Manager is easier to use. Although FWZIP Manager is Framework III based front-end, you can manipulate all types of files; Framework related or not. All existing *.zip files in a chosen directory are displayed on your desktop when you choose PKZIP (or PKUNZIP) functions or certain FWZIP Manager function(s) that require a *.zip file name, so you can easily refer to or cursor point to the particular *.zip file you want to use or act on. This feature is a real boon. Context sensitive on-Line Help for both PKZIP and FWZIP Manager are available from the prompt line menu. The code engine for the on-line FWZIP Manager help uses a unique approach for term or phrase searching, with the default search term being context sensitive. NOTE: the author of FWZIP Manager has no relationship or connection with PKZIP, nor has any rights to it. PKZIP is a copyrighted program, viz: PKZIP (tm) Copyright 1989 PKWARE Inc. All Rights Reserved. ALL references in this documentation and in the FWZIP Manager program are subject to the claims, reservations, trademarks, copyrights, and other rights of PKWARE, Inc. PKWARE, Inc. has endorsed or approved FWZIP Manager. ;{F9} to read Short Description [Start Help] Installation Auto Install Help Auto Help AUTO INSTALL - If you already have not done so, you can automatically install the macros and program by loading the file named "FWZins.fw3" to the desktop, placing the cursor on the frame, and recalculating it by pressing {F5}. You will be instructed and prompted from there for a safe, fast install. *** Install ends with some very basic instructions for a quick trial run. IMPORTANT: The auto install program leaves a frame on your desktop called fwzpathm.fw3 on your desktop. It contains important instructions and information about required DOS path settings. Read it before you run FWZIP Manager !!! See Special Topics - Screen Display, if you do not like the display that appears on your monitor. ; {F9} to read Automatic [Auto Install Help] Manual Install Help Manual Help MANUAL INSTALL - 1. Copy all FWZ prefix files (e.g. FWZ*.*) to your FW3 default drive and directory. FWZ prefix files must always reside in FW3 default drive & directory. NOTE : the documentation file, fwzdoc.fw3, is used by the on-line help engine, so it must be on the path set as the help path (see 4 below); Copy the included macro ( FWZmac.fw3 into your Library FWZmac.fw3 is the macro that is called by an ALT-KEY combination (see next Section for alternatives to using the macro approach); Rename FWZmac.fw3 to the {Alt-key} combination that you desire (I use {Alt-Z} -- the auto install program stores FWZmac.fw3 in your Library as {Alt-Z} and renames any pre-existing {Alt-Z} as "old alt-z"); Paths . Setting three DOS paths are critical to the correct operation of FWZIP Manager. In order of importance, the DOS paths that must be set are: the path to find the PKZIP related *.exe files ( absolutely critical --> program will not ); the default path for zipped files with the *.zip extension not as critical --> but an important convenience ); the path for finding the on-line help file ( not critical to anything BUT on-line Help --> but required in order for on-line help to function) . The auto-install program attempts to set all three paths (to your current path at the time of installation). manually set the path for PKZIP *.exe and *.zip files and documentation see the section on the tilities Menu (or search on-line help for "Set_Path_Help", with space instead of "_"). NOTE: The path statement can NOT end with "\". E.g. "A:", not "A:\" ; and "C:\fw", not"C:\fw\"; 5. See Special Topics - Screen Display, if you do not like the display that appears on your monitor. ; {F9} to read Manual [Manual Install Help] Operating Instructions Using the program Macro Help Run Help APPS Help Program Help Library Help FWZIP Manager can be run one of three ways: As a macro (A small invoking Library kernel called fwzmac.fw3 is included and the auto install program installs it). To run with this option, simply press the {Alt-Key} combination -- {Alt-Z} as auto-installed. As a stand-alone FRED program . To run with this option, load FWZIPMAN.fw3 to your desktop. It does NOT have to be in your Library to run. Place the cursor on the outer most frame label of FWZIPMAN.fw3 and press {Alt-5}. As a program run from a file/utility/program menu. probably have one or more macros which, in turn, pop-up a menu of related or unrelated files, utilities, or programs that are run when selected from the menu. You can install fwzmac.fw3 as a menu choice in your menu (rather than as a Library macro) under any and when it is chosen FWZIPMAN.fw3 will be loaded and run. ; {F9} to read Three options for running FWZIP Manager [Start Help] Cursor Help However you opt to run FWZIP Manager, make sure your cursor is not in a containing frame or cabinet when you run it. ; {F9} to read Cursor placement when running FWZIP Manager [Cursor Help] Menu Choices Menu Help There are several levels of FWZIP Manager, prompt line, menus. On the FIRST level are elp ip Functions tilities Each of these first level menu choices (other than leads to its own respective sub-menu (also on prompt line). Each of these menus and their respective sub-menus are explained in the next following sections. --> [Pgdn}{Pgdn} (or {Ctrl-0}, if you are in on-line help and searched on "Menu_Help") Navigate all FWZIP Manager menus like any other FWIII prompt line menu. That is, choose with cursor by pressing first character of desired choice (as shown by bold-underline in this documentation, see above and below). n as a Library ; {F9} to read Overview Of Menus [Menu Help] Menu Help Help Help [note : this is not a typo, but is a unique word combination that is used by on-line help, as explained below) The initial FWZIP Manager prompt line menu, and every sub-menu, includes a choice for on-line help. Choosing elp from any menu or sub-menu brings up another prompt line sub-menu. It contains two choices; KZIP Help WZipManager Help KZIP Help reproduces PKZip's Help Screen inside a FW word frame on your desktop. It contains command help for PKzip's commands. It is a product of PKWare, Inc. and is part of the PKZIP program. WZipManager Help loads these instructions (you are now reading) to your desktop and prompts you for a search term to locate the part of these instructions you want to read. For example, typing "Help Help", brings you to this Section (that is the purpose of the initial introductory "Help Help" at the beginning of this frame). *** ALERT : These help instructions will not properly load unless the help DOS path is properly set. See installation instructions and et_Path Help below. *** TIP : When you select elp, the prompt-line will suggest a search phrase which is context sensitive. Usually, this is what you want, but it can be overwritten and any valid FW3 search term can be entered. *** TIP : After the first time you use on-line help, an outline of available help topics will appear and stay visible on your desktop. In the outline heading (label) of each section will appear a phrase contained in brackets []. To read a particular section on-line, choose elp and search on the appropriate bracketed phrase, rather than on the program suggested default search phrase. *** TIP : Each of the major sub-menu names and topics are tagged for help in the primary part of this documentation that applies to them with the convention "[sub-menu name or topic] Help". So the meat of these instructions can be reached by searching for the applicable menu name or topic name; for example, you get here by searching for "Help_Help". From time to time, these instructions will "point" you to other parts of the documentation you might want to read by suggesting the phrase to search for, which follows the same convention. But you are not limited to searching this way -- you can search on any valid word or phrase or wild card. NOTE the "_" between Help & Help; in this documentation that "_" represents a space when it is used to suggest an on-line Help search phrase. The "_" prevents Help from finding the suggestion or pointer. When you enter the suggested phrase in the Help search inputline, use a space instead of a "_". When you enter your search term, FWZip Manager's Help sub-routine searches these instructions for your term. It finds each occurrence. When it finds one, it stops there, zooms the screen and highlights your search term. Note: If your search term appears in the label (title), on-line help will NOT find your term in the label (of course, if the term also is in the frame, search will find it). After your search term is found and highlighted, you can read the section and navigate at will; e.g. page down or up from the search term. If you press {Ctrl-0}, the FWZIP Manager Help sub-routine will find the next occurrence of your search term and so on. When the last occurrence of your search term is found, the FWZIP Manager Help sub-routine will quit and return to the prompt line menu. NOTE: When you find your last occurrence of your search term, the next {Ctrl-0} will find it again AND THE next {Ctrl-0} will end. You can quit FWZIP Manager Help at any time before exhausting the occurrences of your search term by pressing {Esc} and then immediately pressing {Ctrl-0}. {ESC} and {CTRL-0} can be pressed as all three keys pressed together, or {esc} can be pressed and released and then {Ctrl-0} pressed together. ; {F9} to read elp Menu -> On-Line Help [Help Help] Menu Help Zip Functions Help PKZIP Help List Help Short Help Long Help -v Help Create Help Add Help Create/Add Help -a Help Freshen Help -f Help Extract Help PKUNZIP Help Delete Help -d Help Other Command Help [note : these are unique word combinations that are used by on-line help] Choosing ip Functions brings up another prompt line sub-menu. It contains six choices; ist reate/Add reshen xtract elete ther Command -- Note: There also is a choice for on-line help, see above Section on the elp Menu. Each of these menu choices (except ther Command and corresponds to a PKZip or PKUNZIP DOS line command. For example, reate/Add corresponds to "-a" in PKZIP. It will be assumed that you know what each of these PKZIP functions do, so I will not dwell on it. Also, through the FWZIP Manager elp menu you have direct access to PKZIP's own Help Screen, if you need help on PKZIP usage. Here follows a brief description of each of FWZIP Manager ip Functions menu choices. Before I go into each choice, an explanation of the common interface that occurs after a menu choice is chosen will save repetition: ===> You choose one of the six menu choices; ** B] A PKZIP Window pops-up on your FW3 desktop, in which PKZIP will be run (unless DOS Roll-out is turned on, see tilities sub-menu explanation and Special Topics below); *** C] Your disk cabinet is opened up, filtered to show only *.zip files for the disk and directory set by the tilities sub-menu; **** D] In the prompt line you are asked to enter a new or existing *.zip file name. If it is an existing *.zip file you can cursor point to the file in your open disk cabinet (and, in so cursor pointing, can navigate to other disks and directories, if you need to "over-ride" your default path setting -- Special Topics : Cursor Pointing search for "Pointing_Help" or "Cursor Pointing_Help" -- NOTE: space instead of "_", which is used here so Help does not go here when searching). When a file name is entered (with full DOS path and *.zip extension), press {Return}. IN all events, even if the chosen *.zip file is on your current FW3 default path, you MUST enter the correct path, which cursor pointing does automatically ***** E] If appropriate, you are asked to enter the file names you want to add, freshen, etc. You can use wild cards, like fwz*.fw3 to add all fw3 files that begin with the "fwz" prefix, or *.com to add all files that end with the "com" suffix. Make sure you include the path name, if different from the current path. If appropriate, the prompt line will contain the default path set under the tilities sub-menu -- you can use it, or delete it and enter a new path; ****** F] PKZIP will run in the FW window (or roll-out to DOS, if opted, see tilities sub-menu and Special Topics); and ******* G] FWZIP Manager will end, with a report of the PKZIP activity on your desktop (unless roll-out, if opted, see tilities sub-menu and Special Topics). ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ >>> Now to each sub-menu choice All but ist, produce immediate action. Each choice is as follows: ist Help: ist leads to a sub-menu that allows you to choose between a ong or hort list of files archived in a particular *.zip file ("-v" and -vb, respectively); reate Help Add Help: reate/Add creates a new *.zip file or adds files to an existing *.zip file; reshen Help: reshen updates files (i.e. replaces older version with newest version) in an existing *.zip file that have been changed since zipped or last freshened; xtract Help: xtract un-compresses (unzips) all or named files in an existing *.zip file. Note: If you intend to extract the files TO a path different from the default path (shown in prompt line when you choose E xtract), manually change the last path statement that appears in the prompt line to the desired destination elete Help: elete removes files from an existing *.zip file; ther Command Help Command Help: ther Command allows you to invoke any other PKZIP related command (using any of the PKZIP related *.exe files), by prompting you for the appropriate COMPLETE DOS line PKZIP command (e.g. "[PATH]\pkzip.exe -L" produces the PKZIP License screen). See PKZIP Help for a list of valid other commands. Make sure all path references required by the PKZIP related *.exe file are included and INCLUDE the ".exe" extension. ; {F9} to read ip Functions Menu -> Access to PKZIP [Zip Functions Help] Menu Help Utilities Help Drive Set Help Set Directory Help Drive Help DOS Help Roll-out? Help Act On Zip File Help Act Help Copy Help Erase Help Move Help Rename Help [note : these are unique word combinations that are used by on-line help] Choosing tilities brings up another prompt line sub-menu. It contains three choices; et Path oll-out? ct on Zip File -- Note: There also is a choice for on-line help, see above Section on the elp Menu. Each is explained below in this Section (except for which is explained in the elp Menu Section): Set Path Help ***>> et Path ** leads to a sub-menu and controls a total of three default DOS path settings. Each choice sets the DOS path (drive and directory), respectively, for finding (again, respectively, in each of their sub-menus) the PKZIP *.exe files, the *.zip files, and the file used by on-line help, fwzdoc.fw3. You set both drive and directory by entering the full path. Enter path like this (without quotes): "C:\fw3\zips" ; or "B:"; or "C:\Windows"; as three examples. Do NOT have "\" as the last character of a path, if path is root end with ":" -- NOT ":\". *** TIP: In some functions, FWZIP Manager extracts the drive statement out of your path entry using the FRED "@mid" statement, so an error in entering the path could cause strange reactions. FWZIP Manager uses these three path settings to find your *.exe files, filter your disk cabinet when displaying existing *.zip files, placing default paths in the prompt line when you are asked to enter file names, and loading the on-line help documentation Auto install initially sets all path settings to the current path it senses on your desktop at the time auto install (fwzins.fw3) is run. You change these settings here. For example, I keep my zip related *.exe and *.zip files for FW3 and other applications in a "\ZIPS" directory, so my path fr *.exe and *.zip files is "C:\zips" and my path for help is "C:\fw". *** TIP: The path settings canNOT end with a "\" When the auto install program senses and sets the initial paths, it observes the foregoing requirement (i.e. no "\"), EXCEPT when it senses a root directory as the default path. If your current path when you install FWZIP Manager is a root directory, the auto install program will incorrectly set the paths by ending them with a "\". Usually, this is only a problem for floppy or hard ram based systems (like my laptop); for a floppy based system auto install sets the path to [drive]\, like "A:\", which will cause FWZIP Manager to abort if a PZZIP function is run from the FWZIP Manager menu. In the event this happens to you: Choose tilities from the FWZIP Manager first level prompt line menu; from the tilities sub-menu choose et Path; from the et Path sub-menu, choose each of the three path setting choices ; delete the LAST "\" from the setting shown in the prompt line, so that it reads "[drive]:", e.g. "A:". REMINDER, this is only a problem if your FWZIP Manager related files reside on your root directory. !!!!!! Save FWZIPMAN.fw3 after you change a setting, want it to stick !!!!!! ALERT: The path settings are crucial. For example, if your *.exe path is wrong (i.e. the needed PKZIP related *.exe file cannot be found there), you will simply get screen flicker and an abort. A wrong or bad path entry can explain most, if not all, problems you may have with FWZIP Manager. Roll-out? Help ***>> oll-out? ** controls whether PKZip runs inside a FW frame/window or rolls-out to DOS to run. The valid settings are "Y" (without quotes) for roll-out and "N" (without quotes) for inside frame/window (which is the default). You will not get a report on your desktop if oll-out? is "Y". Normally, you will want to set oll-out? to "N", unless memory is a problem; See Special Topics - Memory (search in Help with "Memory_Help", with a space instead of a "_") Save FWZIPMAN.fw3 after you change a setting, you want it to stick; Act Help ***>> ct on Zip File ** allows you to easily perform routine DOS chores on *.zip files (which are not controlled by PKZIP), such as erasing *.zip files from disk (versus deleting files from a *.zip file) or moving, copying, or re-naming *.zip files. When you choose this menu choice, FWZIP Manager opens your disk cabinet (with path set by et Path - see above) and filters it to show only *.zip files. Then, while still under control of FWZIP Manager, use normal FW3 commands to act on the *.zip files or files. You can change path with cursor navigation keys ; See Special Topics - Cursor Pointing (search Help on "Pointing_Help", with space instead of "_"). I repeat, you on the selected file with FW3 normal commands as if you were not under the control of FWZIP Manager; for example , [i] use cursor (or {F6} and cursor) to select and [ii] {Del} key to delete/erase the selected files or {F8} to copy. ; {F9} to read tilities Menu -> Special FWZIP Manager functions outside of PKZIP [Utilities Help] Special topics Screen Help Color Help The program was designed on a color VGA (graphics) and looks good on it. It also has been tested on VGA color text and a laptop LCD screen. You may want to adjust color settings to look good on your system. tiliti ; {F9} to read Screen display [Screen Help] Cursor Pointing Help Disk Cabinet Help Enter File Help File Name Help Cursor Help When FWZIP Manager KZIP Functions sub-menu choices prompt you to enter a *.zip file name you can either type in a name (including path, if different from default) or you can enter the name by using FW cursor pointing To enter the name by cursor pointing, follow these steps: 1. When prompted for a *.zip file name, press the grey "Up Arrow" cursor key ( 2. This "activates" FW cursor pointing. In most situations the blinking desktop cursor will (after pressing the "Up Arrow" cursor pad key) be on the open disk cabinet that displays your *.zip files. If not, navigate to it by using {Scroll-lock} and the cursor pad keys, as appropriate. See #5 below for tip on how to change drive and directory; 3. When your blinking cursor is positioned on the open disk cabinet, go in the open disk cabinet by pressing your FW {In} key (grey plus key or {F12}, depending on keyboard); 4. Now you are in a position to select the *.zip file you want, by pressing {Return}, which will put the file name and path in your prompt line. Press {Return} again, to enter that path and name as your input, or cursor point again or edit to change/edit selection; 5. *** Tip : FWZIP Manager filters your disk cabinet based on the drive and directory you set through the FWZIP Manager tilities / et Path sub-menus. THAT default, et Path setting can be over-ridden at this point during cursor pointing Here, to do so, you need some familiarity with FW3 disk cabinet navigation, but basically, you can change drive and directory "on the fly" during cursor pointing by using your {In}, {Out}, {Up Arrow}, and {Dn Arrow} keys (with or without the {Ctrl-} prefix). As you so change path during cursor pointing, the filter is active (so long as you do not change drives), so only *.zip files show as you change directory. For example, if your initial disk/directory is set to "C:\fw", to choose a *.zip file in your Dbase directory, press {Ctrl-out} {Out} {In}, place cursor on your DBASE directory name, press {In} to open that directory, and now choose a *.zip file from those showing; 6. At any rate, when you select a *.zip file with your cursor, press {Enter}. The selected *.zip file name (with path) will be in your prompt line text entry section. 7. Leave the path produced by cursor pointing, press {Return}. 8. You have just entered the selected path\*.zip file name on which FWZIP Manager will act. ; {F9} to read Entering *.Zip File Names by Cursor Pointing [Cursor Pointing Help] EnterinG Memory Help In order for PKZIP to run inside a FW3 frame/window on your desktop, FW3 must have available enough conventional memory to do so. I repeat "conventional" memory; i.e. base 640K; even if you are showing mega-memory with {Alt-F5} you may have insufficient memory to run PKZIP inside a FW3 frame/window. This condition (whether or not you have sufficient memory) can change session to session and minute by minute, depending on a host of factors and even varies depending on the PKZIP function being used and the size of the *.zip file. So that FWZIP Manager is not disabled when you have insufficient memory to run PKZIP inside a FW3 frame/window, FWZIP Manager has a setting to roll-out to DOS before running PKZIP. This setting is controlled by oll-out? in the tilities menu; "N" to turn roll-out off (the default) and "Y" to turn roll-out on. oll-out? is on ("Y"), you will not have a report of PKZIP activities on your desktop. this (wit ; {F9} to read Memory [Memory Help] Extracting Help Self Extracting Help PKZIP includes a file for converting a zip file (*.zip) to a self-extracting file with an *.exe file. See PKZIP documentation on how to do this with PKZIP. ASSUMING all of the several necessary PKZIP *.exe and *.com files reside on the DOS path you set for FWZIP Manager to find PKZIP related *.exe files , you can use FWZIP Manager to make a zipped file self-extracting by : 1] Choose the ip Functions sub-menu; 2] From the resulting sub-menu, choose ther Command; 3] When prompted for the command, delete any incorrect defaults in the prompt line and enter the proper *.exe files, commands, and *.zip files (and paths) to execute the self-extracting program as if you were at the DOS prompt. ; {F9} to read Making Zip Files self-extracting [Self Extracting Help] On-line Help Help You access on-line FWZIP Manager Help two (2) ways: For PKZIP Help choose KZIP Help from any elp sub-menu and the PKZIP Help screen that comes with PKZIP will be written on your desktop inside a FW3 window/frame; For FWZIP Manager Help , choose WZIP Help from any sub-menu. You will be prompted to enter a term or phrase for Help to search. The prompt-line will contain a suggested, context sensitive, search phrase. After the first time you use on-line help, an outline of available help topics will appear and stay visible on your desktop. In the outline heading (label) of each section will appear a phrase contained in brackets []. To read a particular section on-line, choose elp and search on the appropriate bracketed phrase. *** For further details search Help for "Help_Help" (with a space instead of "_") or see above Section on the elp Menu. ; {F9} to read HELP [On-line Help Help] FW Menu Bar Help The FW menu bar settings can be important and sometimes explain (and fix) what at first appears to be a bug in the program. For example, if you have Locate Ignore Capitalization off, then your elp search will be sensitive to capitalization. ; {F9} to read The effect of Framework menu settings [FW Menu Bar Help] The eff3 Included Files Help FWZread.fw3 - intro "readme" text file that directs you to read these instructions FWZins.fw3 - the auto install program FWZms1.fw3 - auto install pop-up instructions FWZms2.fw3 - basic instructions for a quick test run FWZms3.fw3 - basic instructions cross-referenced to full documentation FWZpathm.FW3 - an alert AND special instructions left by the auto-install program concerning the setting of DOS paths for FWZIP Manager to use FWZIPMAN.fw3 - the main program FWZmac.fw3 - the Library (or APPS menu) kernel FWZdoc.FW3 - these instructions ; {F9} to read Files Included With FWZM.zip - All must be installed on your FW3 default drive and path change to be accurate [Included Files Help] ault drive and Version Help About Help About FWZIP Manager ; FWZIP Manager ; by Gary Reger ;VERSION 90-11-13 ; (c) copyright claimed ;.......................................... PLEASE REPORT ANY BUGS AND LET ME HAVE YOUR SUGGESTIONS, Thanks, Gary Reger, CIS # 72416,3377. ; {F9} to read Version information [Version Help]